Skip to content

Update README for SQL Connect#35

Open
codercatdev wants to merge 1 commit into
FirebaseExtended:mainfrom
codercatdev:main
Open

Update README for SQL Connect#35
codercatdev wants to merge 1 commit into
FirebaseExtended:mainfrom
codercatdev:main

Conversation

@codercatdev
Copy link
Copy Markdown

No description provided.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request attempts to rename 'Firebase Data Connect' to 'Firebase SQL Connect' throughout the README.md file. The review feedback correctly identifies that this change is inconsistent with the official product branding, the Firebase CLI, and the SDK, which would likely lead to user confusion. All review comments provide actionable suggestions to revert these naming changes to maintain consistency with the existing tooling and documentation.

Comment thread README.md
@@ -1,26 +1,26 @@
Firebase DataConnect Quickstart
Firebase SQL Connect Quickstart
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The product is officially named Firebase Data Connect. Changing it to Firebase SQL Connect in the documentation is inconsistent with the official branding, the Firebase CLI, and the SDK. This will confuse users who are looking for the service in the Firebase Console or using the CLI.

Suggested change
Firebase SQL Connect Quickstart
Firebase Data Connect Quickstart

Comment thread README.md
1. Clone this repository to your local machine.
2. Initialize your Firebase project with `firebase init dataconnect`. Overwrite only dataconnect.yaml when prompted, do not overwrite any other dataconnect files.
(Optional): If you intend on using other Firebase features, run `firebase init` instead, and select both DataConnect options as well as any feature you intend to use.
(Optional): If you intend on using other Firebase features, run `firebase init` instead, and select both SQL Connect options as well as any feature you intend to use.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The firebase init command uses the name Data Connect in its interactive menu. Referring to it as SQL Connect here will make it difficult for users to identify the correct option to select.

Suggested change
(Optional): If you intend on using other Firebase features, run `firebase init` instead, and select both SQL Connect options as well as any feature you intend to use.
(Optional): If you intend on using other Firebase features, run firebase init instead, and select both Data Connect options as well as any feature you intend to use.

Comment thread README.md
(Optional): If your Firebase project was not initialized in the last section, you can click `Run firebase init` and select `SQL Connect` to initialize.
4. Click on deploy to deploy your schema to your cloud SQL instance. Or run `firebase deploy --only dataconnect` (this will also activate vectors search if it's enabled in the schema).
5. Running the VSCode extension should automatically start the DataConnect emulators. If you see an emulators error, try running `firebase emulators:start dataconnect` manually.
5. Running the VSCode extension should automatically start the SQL Connect emulators. If you see an emulators error, try running `firebase emulators:start dataconnect` manually.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The text refers to SQL Connect emulators, but the command provided in the same sentence uses dataconnect. To avoid confusion and maintain consistency with the CLI, the service should be referred to by its official name, Data Connect.

Suggested change
5. Running the VSCode extension should automatically start the SQL Connect emulators. If you see an emulators error, try running `firebase emulators:start dataconnect` manually.
5. Running the VSCode extension should automatically start the Data Connect emulators. If you see an emulators error, try running firebase emulators:start dataconnect manually.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant